All documentation for the VideoToolbox is now live, at the web site:
<http://rajsky.psych.nyu.edu/VideoToolbox/>
A convenient way to get there, if you have NetScape, is to double-click the "VideoToolbox.html" NetScape document in your VideoToolbox folder.
The VideoToolbox is a collection of two hundred C subroutines and several demo and utility programs that I and others have written to do visual psychophysics with Macintosh computers. It is fully compatible with 680x0 and PowerPC Macs and with Metrowerks CodeWarrior and Symantec C compilers. It's free and may not be sold without permission. It should be useful to anyone who wants to present accurately specified visual stimuli or use the Mac for psychometric experiments. The "Video synch" page discusses all the ways of synchronizing programs to video displays and the many pitfalls to avoid. The TimeVideo application checks out the timing of all video devices in anticipation of their use in critical real-time applications, e.g. movies or lookup table animation. "Video synch" reports all known bugs uncovered by TimeVideo's testing of 56 video cards and drivers. Low-level routines control video timing and lookup tables, display real-time movies, and implement the luminance-control algorithms suggested by Pelli and Zhang (1991). In particular, CopyWindows (or CopyBitsQuickly) faithfully copies between on-screen and off-screen windows (or bit/pixmaps), WindowToEPS saves an image to disk as encapsulated PostScript, for later printing or incorporation into a document, and SetEntriesQuickly and GDSetEntries load the screen's color lookup table, all without any of QuickDraw's color translations. NoisePdfFill.c quickly generates visual noise images whose pixels are samples from a specified probability density function. High-level routines help analyze psychophysical experiments (e.g. maximum-likelihood fitting and graphing of psychometric data). Assign.c is a runtime C interpreter for C assignment statements, which is useful for controlling experiments and sharing calibration data. This collection has been continually updated since 1991. Nearly two hundred colleagues subscribe to the email distribution (see below), and have indicated that they are using the software in their labs. Documentation is in the source files themselves. Many of the routines are Mac-specific, but some very useful routines, e.g. the luminance-control, statistics, maximum-likelihood fitting algorithms, and the runtime interpreter are written in Standard C and will work on any computer. Those wishing to acknowledge use of the VideoToolbox software might cite:
Pelli, D. G. and Zhang, L. (1991) Accurate control of contrast on microcomputer displays. Vision Research, 31, 1337-1350. Reprints are available.
or
Pelli, D.G. (1997) The VideoToolbox software for visual psychophysics: Transforming numbers into movies. Spatial Vision 10(4):437-442.
It's on the web: <http://rajsky.psych.nyu.edu/VideoToolbox/VideoToolbox.html>
IMPORTANT: Since March, 1996, CopyBitsQuickly.c, for highest possible speed, now uses Apple's BlockMoveDataUncached() on PCI Macs, and BlockMoveData() otherwise. As a consequence, all PowerPC projects that include CopyBitsQuickly.c must add DriverServicesLib (from the new VideoToolbox "Libs" folder), which has the glue needed to call BlockMoveDataUncached(). Similarly, Identify.c uses NameRegistryLib to obtain more detailed information about PCI Macs. If you're using CodeWarrior, after adding DriverServicesLib and NameRegistryLib to your project, press the little arrows next to DriverServicesLib and NameRegistryLib and select "import 'weak'" from the pop-up menu. When you Make, ignore the Link Warning that BlockMove and BlockMoveData were previously defined in InterfaceLib. E.g. see the demo TimeVideo.
THE FINE PRINT: Copyright (c) 1989-1997 Denis G. Pelli. The accompanying software is free; you may use it in your research and give it away to others, with the following restrictions. Any copy you give away must include this paragraph, unmodified, and any file that you have changed must include a note, added to HISTORY, giving your name, the date, and a description of the changes. This software may not be sold, whether in source or compiled form, without my permission. I hereby grant permission to include the whole VideoToolbox in multi-megabyte collections of software that sell for less than $100, since such sales enhance public access to the public software archives. I hope you will find this software useful, but I can't promise that it will work for you, and am not offering any support. That's why it's free. I would appreciate reports of bugs and improvements.
SetMouse.c and HideMenuBar.c are copyrighted by SPLASH Resources. Their restrictions are reproduced in those files. FlushCacheRange.c (originally called Cache.c) is copyrighted by Apple Computer Corp. The compiled applications incorporate code copyrighted by others: Copyright (c) 1989 THINK Technologies, Inc. Certain portions of this software are copyrighted by THINK Technologies, Inc. Copyright (c) 1988 Cambridge University Press. The Numerical Recipes in C are copyrighted by Cambridge University Press. KillEveryoneButMe.c is based on a routine of the same name by C.K. Haun, Copyright (c) 1991-2 Apple Computer.
DISCLAIMER (included at the request of the MacPsych archive): The VideoToolbox is provided "as is" without warranty of any kind. Denis Pelli, New York University, SCiP, the operators of MacPsych, and St. Olaf College make no claims concerning the accuracy or correctness of the computer code contained in, or the results of the use of VideoToolbox. The entire risk as to the results and performance of VideoToolbox is assumed by you. If the VideoToolbox is defective you, and not Denis Pelli, New York University, SCiP, the operators of MacPsych, or St. Olaf College assume the entire cost of all necessary servicing, repair or correction.
